package cn.edu.pzhu.javaweb.dao;

import java.sql.Connection;
import java.util.List;

/**
 * DAO层公共接口
 * 定义通用的数据访问操作
 * 
 * @param <T>  实体类型
 * @param <ID> 主键类型
 */
public interface BaseDao<T, ID> {

    /**
     * 插入一条记录
     * 
     * @param entity 实体对象
     * @return 影响的行数
     */
    int insert(T entity);
    int insert(T entity,Connection con);
    
    /**
     * 根据ID删除记录
     * 
     * @param id 主键ID
     * @return 影响的行数
     */
    int deleteById(ID id);

    /**
     * 根据ID批量删除记录
     * 
     * @param ids 主键ID集合
     * @return 影响的行数
     */
    int deleteBatchIds(List<ID> ids);

    /**
     * 根据ID更新记录
     * 
     * @param entity 实体对象（包含ID）
     * @return 影响的行数
     */
    int updateById(T entity);

    /**
     * 根据ID查询记录
     * 
     * @param id 主键ID
     * @return 实体对象
     */
    T selectById(ID id);

    /**
     * 根据ID批量查询记录
     * 
     * @param ids 主键ID集合
     * @return 实体对象列表
     */
    List<T> selectBatchIds(List<ID> ids);

    /**
     * 查询所有记录
     * 
     * @return 所有实体对象列表
     */
    List<T> selectAll();

    /**
     * 根据条件查询记录
     * 
     * @param condition 查询条件
     * @return 符合条件的实体对象列表
     */
    List<T> selectByCondition(T condition);

    /**
     * 统计总记录数
     * 
     * @return 总记录数
     */
    long selectCount();

    /**
     * 根据条件统计记录数
     * 
     * @param condition 查询条件
     * @return 符合条件的记录数
     */
    long selectCountByCondition(T condition);

    /**
     * 分页查询
     * 
     * @param pageNum  页码
     * @param pageSize 每页大小
     * @return 分页数据列表
     */
    List<T> selectPage(int pageNum, int pageSize);

    /**
     * 根据条件分页查询
     * 
     * @param condition 查询条件
     * @param pageNum   页码
     * @param pageSize  每页大小
     * @return 分页数据列表
     */
    List<T> selectPageByCondition(T condition, int pageNum, int pageSize);

    /**
     * 判断ID是否存在
     * 
     * @param id 主键ID
     * @return 是否存在
     */
    boolean existsById(ID id);
}